XML.load()

Доступность

Flash Player 5; behavior changed in Flash Player 7.

Синтаксис

my_xml.load(url:String) : Void

Параметры

url Строка, представляющая собой URL, откуда загружается XML документ. Если SWF, выполняющий данный запрос, запущен в браузере, url должен быть в том же домене, что и SWF файл; подробнее смотри в разделе Описание ниже.

Возвращает

Ничего.

Описание

Метод; загружает XML документ с указанного URL и заменяет содержимое вызвавшего его XML объекта загруженными XML данными. URL может быть относительным и должен быть доступен по HTTP. Загрузка проходит асинхронно; она не завершается сразу после вызова метода load() и требует определенного времени.

В SWF файлах, опубликованных для версий Flash Player, младше 7й, параметр url должен находиться в том же наддомене (superdomain), что и SWF файл, осуществляющий запрос. Наддомен получается путем удаления самой левой части из адреса URL. Например, SWF файл по адресу www.someDomain.com может загружать данные с store.someDomain.com, потому что оба файла находятся в одном наддомене, someDomain.com.

В SWF файлах, опубликованных для Flash Player 7 или более поздних версий, параметр url должен указывать на файл в том же самом домене (смотри "Безопасность во Flash Player" в Использовании ActionScript во Flash). Например, SWF файл по адресу www.someDomain.com может загружать данные только из источников, находящихся в том же самом домене, www.someDomain.com. Если Вы хотите загружать данные с других доменов, вам необходимо поместить файл с разрешением на кросс-доменный доступ (cross-domain policy file) на сервер, с которого SWF файл будет получать данные. Для более подробной информации смотри "О кросс-доменной загрузке данных " в Использовании ActionScript во Flash.

При исполнении метода load(), свойство loaded XML объекта делается равным false. Когда XML документ загружен, свойство loaded становится равным true и вызывается обработчик события onLoad. XML данные не обрабатываются анализатором (парсером) до момента полной загрузки документа. Если объект XML до начала загрузки содержал XML дерево, оно уничтожается.

Вы можете задать собственную функцию, вызываемую при срабатывании обработчика события onLoad объекта XML.

Пример

В следующем примере используется метод XML.load():

// Создаем новый XML документ
var flooring:XML = new XML();

// Делаем значение свойства ignoreWhite равным true (значение по умолчанию false)
flooring.ignoreWhite = true;

// По окончанию загрузки выводим содержимое XML документа
flooring.onLoad = function(success) {
  trace(flooring);
};

// загружаем XML документа в объект flooring
flooring.load("flooring.xml");

Содержимое файла flooring.xml и данные, выводимые на панель Output в данном примере, смотри в примере для XML.ignoreWhite.

См. также

XML.loaded, XML.onLoad

Смотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление